home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Precision Software Appli…tions Silver Collection 4
/
Precision Software Applications Silver Collection Volume 4 (1993).iso
/
new
/
cmedt317.arj
/
CMEDITOR.DOC
< prev
next >
Wrap
Text File
|
1993-01-30
|
25KB
|
612 lines
*******************************
* *
* CMEditor -- Version 3.16 *
* *
*******************************
Background:
CMEditor was originally written as the editor module for CMFiler, my
multipurpose disk/file manager designed to bring together and simplify
99% of the file management functions you would ever need. I recently
broke out a standalone version at the urging of several users. If you
find CMEditor useful and continue to use it beyond a 60-day evaluation
period, I require that you register your copy for $10. Please read the
section on registration, and note the benefit of receiving on-disk a
registered copy of the current version of CMEditor, a copy of the
shareware version of CMFiler for your evaluation, and, by permission of
the author, a copy of the shareware version of Integrity Master, the
outstanding anti-virus and system integrity program by Wolfgang Stiller.
Note that the versions of CMFiler and Integrity Master provided in this
offer are for your evaluation and MUST be registered for the fee required
by the author if you continue to use them beyond a fixed evaluation
period.
-----
Running CMEditor. . .
First, you may rename CMEDITOR.COM to CE.COM, to reduce the number
of keystrokes required to run it. Execute CE from the DOS prompt with
the following command line:
CE FILESPEC [V] [colorparam]
where:
FILESPEC is the specification of the file to be edited,
V is an optional "view-only, no edit" switch, and;
colorparam is an optional color parameter, M, L or T to force more
readable color sets for Monochrome, LCD and Tandy LCD monitors,
respectively.
_____
Record Delimiters. . .
The default display mode for "record delimiters" [carriage return
(CR), line feed (LF), and the combinations CR+LF and LF+CR] is to show
their color values, which are cued in the legend at the bottom (blue=CR,
green=LF, cyan=CR+LF, magenta=LF+CR). In addition , the end of the file
is denoted with a red End-of-File (EOF) mark. Sometimes it is very useful
to know exactly what delimiter combination your word processors use, so
you can duplicate it when you edit with CE. You can toggle the colored
delimiter symbols off and on with "Alt-Minus" or Gray-. (This is also
covered in a help screen you can get by pressing Alt-H or F1.)
_____
Information Area. . .
The name of the file being viewed is shown in the lower left prompt
area. The lower right prompt area shows the ASCII value of the character
at the cursor (decimal and hex), the position of that character in the
file (starting with 1), the file record the cursor is in, and the
position of the cursor within the record (called "Column", which for a
long record is not necessarily the same as the screen column). This
information display may be toggled off and on with "Alt-Plus" or Gray+.
_____
Line Wrapping. . .
The default display mode is line wrapping, where any record longer
than 80 characters is wrapped to the next screen line, so that all text
is visible. This mode can be toggled (see the Wr/NW -- for "Wrap" or "No
Wrap" mode -- at upper right for current status) with Alt-W. In the NW
mode, each record longer than 80 characters simply extends off the screen
to the right, but is accessible for viewing by putting the cursor on it
and [Ctrl- or Shift-] Rt Arrow-ing (see below) to any place on the line.
-----
Cursor Movement. . .
The arrow keys move the cursor one line up or down and one character
left or right. Ctrl-Left/Rt Arrow move left or right one word at a time,
and Shift-Left/Rt Arrow and Home/End move to the beginning/end of the
line, as in PCWrite.
PgDn/PgUp moves the display up or down 20 screen lines, and leaves
the cursor on the same video line. Ctrl-PgUp/PgDn moves the display by
200 screen lines (10 video pages) for fast paging through a file. Shift-
CMEditor -- User's Manual 2
Up/Down Arrow moves to the top/bottom of the current page. Alt-B moves
to the Beginning of the file contents in memory; Alt-E moves to the End.
For very LONG files, exceeding available memory, the editor loads
only as much as fits. When you get to the end of that section (i.e., the
current "file contents in memory" referred to above), the next operation
that asks for another page or line causes the editor to load in the next
section, remembering the file position of the start of the previous
section so it can backtrack if you want. (It actually loads the next
section with some overlap to the previous section, so that a little bit
of backtracking does not result in reloading the whole previous section.)
This "heel-and-toe" sequential loading is limited to 50 sections.
_____
Find a String. . .
Want to look for a particular word or string of characters? The
key combination Alt-F (for "Find") opens up a data window at the
bottom for you to enter a short string. After you press Enter, CE
will find the first appearance of the string from the current cusor
position, and put the cursor on it. Alt-X (for "neXt") finds the
next appearance, and can be used repeatedly until the string no longer
appears, which is signalled at the bottom of the screen. The search
process starts at the cursor location and goes, if necessary, to the end
of the current file contents in memory.
If the file is long and is being viewed by the editor module in
sections as discussed above, only the CURRENT section is available to the
Find operator. The search is case-insensitive.
_____
Leading and Trailing Blanks in the Data Window. . .
The data entry routine truncates leading and trailing blanks, but
blanks may be included as leading or trailing characters by enclosing the
string at either or both ends with quotes ("). Suppose, for example, you
wanted to find all of the appearances in a file of the word "mark", but
not "remark". Press Alt-F and, in the data entry window enter:
Find string: >" mark <. This works for the replace string
as well.
_____
Edit Mode Limitations. . .
CE permits edit mode only if the file fits all at once into available
memory, has fewer than 16,380 records, and has no record longer than 8190
bytes. CE will revert to view mode if these conditions are not all
satisfied. If you have a lot of memory tied up in resident programs or
CMEditor -- User's Manual 3
RAM disk/cache, then you may not be able to edit extremely large files.
Chances are, however, that this will never be a practical limitation.
_____
Typeover vs Insert. . .
Look at the upper right. "Vw" means View mode, "T/O" means Edit in
Typeover mode, "Ins" Insert. Toggle between T/O and Ins with the Insert
key. Switch from View to Edit mode with Alt-S (for "Switch mode").
Typing action in Edit mode is just like any other editor, except in
typeover mode, the Bksp key does not pull the text left. This is to
avoid unintentionally shortening the file when editing length-sensitive
files, such as .COM and .EXE files.
_____
Editing a Line. . .
You operate on a line at a time, and the "normal" editing keys work
-- i.e. Bksp, Del, Tab, Shift-Tab, the unmodified and modified arrow keys
discussed above, and any ASCII-code keys. To create a new line, just
Home/End or Shift-Arrow to the beginning or end of the current line,
depending on whether you want the new line above or below the current
one, and hit Enter. This inserts the default delimiter combination,
CR+LF, into the text to set up a new line void of text, but ready for you
to start typing. The combination Ctrl-Enter gives you a menu screen from
which you may select a different record delimiter. Join two lines by
deleting the record delimiter at the end of the first line to be joined.
Delete a line with Ctrl-Y ("Yank"). Delete from the cursor to the end of
the line with Ctrl-D. Delete a word and its associated whitespace with
Ctrl-T.
_____
More on Record Delimiters. . .
On CGA/EGA/VGA monitors, the record delimiter appears as a single
colored "blank" character at the end of the line, whether it is actually
two characters (eg., CR+LF) or one (eg., LF). It may be deleted to join
two lines, but not over-struck -- it always pushes right, even when
you are in typeover mode. The red "End-of-File" (EOF) marker is not
actually part of your file, but rather is only a visual aid for you to
see where the text ends. When the cursor is on the EOF marker, the
"byte number" in the legend corresponds to the number of the next
character, if you were to type one. The EOF marker also always pushes
right, and cannot be deleted. The height of the cursor shows the
status of the "Caps Lock" switch.
CMEditor -- User's Manual 4
_____
Alt- Keypad and Alt-N. . .
Any ASCII code from 1 through 255 can be entered from the numeric
keypad using the Alt- key modifier. A special combination is provided
for ASCII zero ("NULL"), since "Alt-0" is not recognized by any keyboard
drivers I have seen. It is "Alt-N" (for "Null").
_____
Block Operations. . .or the REAL Power of CE's Editor. . .
All the block operations -- there are six -- are keyed to Alt- key
combinations, and they are all intuitive (sort of). They are:
Alt-{ Mark, Yank (delete), moVe, Copy, Print and Output }.
_____
Marking a Block, and the Copy Buffer. . .
You may also manipulate blocks of records. First mark a block by
putting the cursor on the first (or last) record of the block you want
to do something with, press Alt-M (for "Mark"), move down (or up) with
arrows, PgDn/Up, etc., and mark the last (or first) record of the block,
again with Alt-M. The marked text is written into a copy buffer for
later use. If you made a mistake, a third press of Alt-M clears the
marks, but leaves the copy buffer intact. The contents of this copy
buffer REMAIN AVAILABLE FOR MULTIPLE USE UNTIL A NEW BLOCK IS MARKED.
When you are marking a block, note that the information box at the
bottom left of the screen expands to show you the attributes of the
marked block -- the number of the first and last records marked, and the
number of bytes in the painted area. There is an arbitrary 32 KB limit
on the copy buffer.
_____
Delete, Copy, Move. . .
Delete the block with Alt-Y ("Yank"). Or put the cursor in an
unpainted area of the file, and copy the block into that area, just ahead
of the line where you put the cursor, by pressing Alt-C ("Copy"). Or
move it with Alt-V ("moVe"). As noted above, the block previously
"marked" into the copy buffer is available for multiple use. Just put
the cursor where you want the block to be copied and hit Alt-C again.
CMEditor -- User's Manual 5
_____
Restoring from Inadvertent Block Deletion. . .
If you just deleted a block in error, put the cursor where you want
to restore it, and press Alt-C to copy the buffer back into the file.
_____
Sending a Block of Text to the Line Printer. . .
Print the copy buffer to line printer 1 (the parallel port) with
Alt-P ("Print"). After printing, if you want a form feed, press Ctrl-F
("Form feed" -- note the use of Ctrl- vice Alt- as the modifier key,
since Alt-F was already used for "Find").
. . .or to a File. . .
Finally, output the copy buffer to a file in the current path by
pressing Alt-O (letter "O" for "Output"). A window opens at the bottom
for typing the name of the file for CE to create (if it doesn't already
exist) or append to if it does. (The file will be created or opened in
the current directory on the default drive. Therefore the characters ":"
and "\" will not be recognized.)
_____
Replace and Global replace. . .
In addition to the Alt-F "find" feature, there is an Alt-R
"replace" and an Alt-G "global replace" feature. Just press Alt-R or
Alt-G and enter the find and replace strings when prompted. (If you see
a mistake in the find string while you are typing the replace string,
just arrow back up a line and reedit it.) For Alt-R, CE will find the
first match and ask you to confirm the replacement. It continues finding
and requesting confirmation until you press Q (for "quit replacing").
Alt-X reactivates either the find or replace routine, whichever was used
last. Alt-G replaces all appearances of the find string with no
confirmation. It may be terminated with any key press. When global
replace was thus terminated, Alt-X reactivates the confirmatory replace,
not the global replace.
_____
Leaving CMEditor. . .
After editing is complete, press Esc. The next prompt you get
asks whether you want to save this edit (y/n), or go back to the editor
(Esc). (If you had hit the Esc key by mistake, hit it again to
return to where you were.) In some cases you botched the file up so bad
you don't want to save it, but most of the time you do. Press Y. The
CMEditor -- User's Manual 6
next prompt wants to know if you want to save the original, pre-edit
version of the file as "*.BKP" (an arbitrary extension designator I
picked to show the file as a "BacKuP" from edit mode, different from the
form of the backup extension assigned by the backup command B from the
main module.) If you say no, the edited version will simply overwrite
the original. If you say yes, then the previous backup file with the
same name and extension ".BKP", if there is one, will be deleted, the
"current" original file will be renamed with the ".BKP" extension, and
the now-edited version will be saved under the original name. If CE runs
out of file space, it will ask you to put a NEW disk into drive A to save
the edited version.
CE also automatically records the state of four parameters to be the
defaults for the next time it is executed. These are the show-delimiter
and show-bottom-display switches, the typeover/insert mode, and the line-
wrap mode.
_____
Backup File Protection. . .
A small point of backup file protection. If, in the process of
saving the original version of the edited file, CE encounters a file
with the same name and the ".BKP" extension, it will simply overwrite
it, UNLESS it is assigned the read-only attribute and the original to
be renamed and saved is not. In this case CE will give you the option
of saving the read-only file.
_____
Help. . .
A one-page help screen may be summoned on-line at any time in the
editor with the command F1 or Alt-H, and exited with any keystroke.
CMEditor -- User's Manual 7
*******************************
* *
* CMEditor -- Version 3.16 *
* *
*******************************
REGISTRATION INFORMATION:
Definition of Shareware. . .
Shareware distribution gives users a chance to try software
before buying it. If you try a Shareware program and continue
using it, you are expected to register. Individual programs
differ on details -- some request registration while others
require it, some specify a maximum trial period. With
registration, you get anything from the simple right to continue
using the software to an updated program with printed manual.
Copyright laws apply to both Shareware and commercial software,
and the copyright holder retains all rights, with a few specific
exceptions as stated below. Shareware authors are accomplished
programmers, just like commercial authors, and the programs are
of comparable quality. (In both cases, there are good programs
and bad ones!) The main difference is in the method of
distribution. The author specifically grants the right to copy
and distribute the software, either to all and sundry or to a
specific group. For example, some authors require written
permission before a commercial disk vendor may copy their
Shareware.
Shareware is a distribution method, not a type of software. You
should find software that suits your needs and pocketbook,
whether it's commercial or Shareware. The Shareware system makes
fitting your needs easier, because you can try before you buy.
And because the overhead is low, prices are low also. Shareware
has the ultimate money-back guarantee -- if you don't use the
product, you don't pay for it.
_____
Ombudsman Statement. . .
This program program is produced by a member of the Association of
Shareware Professionals (ASP). ASP wants to make sure that the shareware
principle works for you. If you are unable to resolve a shareware-related
problem with an ASP member by contacting the member directly, ASP may be
able to help. The ASP Ombudsman can help you resolve a dispute or problem
with an ASP member, but does not provide technical support for members'
CMEditor - Registration 8
products. Please write to the ASP Ombudsman at 545 Grover Road, Muskegon,
MI 49442 or send a CompuServe message via CompuServe Mail to ASP
Ombudsman 70007,3536.
_____
CMEditor Disclaimer - Agreement. . .
Users of CMEditor must accept this disclaimer of warranty: CMEditor
is supplied as-is. The author disclaims all warranties, expressed or
implied, including, without limitation, the warranties of merchantability
and of fitness for any purpose. The author assumes no liability for
damages, direct or consequential, which may result from the use of
CMEditor.
_____
Registration. . .
CMEditor is a copyrighted Shareware program by Charles F. Martin,
President, NoVaSoft and author member of the Association of Shareware
Professionals. The evaluation version of CMEditor is offered at no charge
to any potential user for evaluation. Feel free to share it with your
friends, but please do not give it away altered or as part of another
system. The essence of "user-supported" software is to provide personal
computer users with quality software without high prices, and yet to
provide incentive for programmers to continue to develop new products.
If you find this program useful and find that you are using CMEditor
after a 60-day trial period, you must make a registration payment of $10.
Checks may be made payable to Charles F. Martin or NoVaSoft. You will be
sent by return mail a registered copy of the latest version of CMEditor
with hard copy of the user's manual. You are entitled to have as many
copies of it as you wish (for example, one on each computer you use at
home and work, plus one for your briefcase), with the understanding that
these are for YOUR personal use and demonstration to others. Please
recognize that this is a CONSIDERABLY relaxed condition on copying and
usage than some authors specify. It is done for YOUR convenience.
Registration also entitles you to user support by mail or CompuServe
E-mail for at least one year, to a free copy by mail of the current
registered version of CMEditor, and on-disk copies of the shareware
versions of my disk/file manager CMFiler, and, by permission of the
author, Wolfgang Stiller's outstanding anti-virus/system integrity
package Integrity Master. Please note that these latter two programs are
for evaluation only, and must each be registered for a fee with the
author if you continue to use them beyond a period of evaluation set by
the author.
Prospective commercial users of CMEditor may contact the author to
arrange for a site license.
CMEditor - Registration 9
Distributors and BBS sysops recognized by the Association of
Shareware Professionals (ASP) as adhering to its guidelines for shareware
distributors may begin offering CMEditor in their catalogs/BBS services
immediately, and will automatically receive updates by mail by virtue of
their ASP membership. Other distributors whose only remuneration is a
nominal fee for the disk itself, and whose literature makes it clear to
their buyers that the program material must be separately purchased from
the author, may also offer CMEditor immediately, but should inform me so
that I can provide them periodic updates. Distributors who wish to sell
CMEditor packaged as or in a retail product must contact me, and are not
authorized to distribute this version of CMEditor.
Charles F. Martin
President, NoVaSoft
3239 Riverview Dr.
Triangle, VA 22172-1421 USA
Phone (703) 221-1471 or 221-1833
CompuServe 72130,1400
Internet 72130.1400@compuserve.com
CMEditor - Registration 10
------------------- CMEditor REGISTRATION FORM -----------------------
[Make checks payable to Charles F. Martin or NoVaSoft]
[Mail to 3239 Riverview Dr., Triangle, VA 22172-1421 USA]
______________________________________________________________________
Name of Registrant Date
______________________________________________________________________
Street
______________________________________________________________________
City State Zip
Enclosed is $10 to register my copy of CMEditor Version 3.16. (Make
checks payable to Charles F. Martin or NoVaSoft.) I understand I will
receive user support by mail for at least one year. CompuServe
subscribers may receive their user support by CIS E-mail.
My CIS User ID is:____________________________________________________
I also understand I will receive on disk a copy of the current registered
version of CMEditor, and shareware copies of CMFiler and Wolfgang
Stiller's Integrity Master anti-virus/system integrity package. I
understand that these latter two programs are for my evaluation only, and
that I must register each separately with the respective author if I
continue to use either/both beyond the authors' defined evaluation
period.
_ _
Specify: |_| 5.25" DSDD |_| 3.5" DSDD floppy disk
I also have the following suggestions for improving CMEditor, or have
found the following bugs (attach additional sheets if needed):
______________________________________________________________________
______________________________________________________________________
CMEditor - Registration Form